Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Transforming Shapes by Modifying Transform Mappings

GXMoveTransform

You can use the GXMoveTransform function to alter the mapping property of a transform object so that it moves its associated shape by a specified horizontal and vertical distance.

void GXMoveTransform(gxTransform target, Fixed deltaX, 
                     Fixed deltaY);

target

A reference to the transform object whose mapping property you want to alter.

deltaX

The horizontal distance.

deltaY

The vertical distance.

DESCRIPTION

The GXMoveTransform function calculates a new mapping matrix for the transform object referenced by the target parameter. When applied to a shape, the new matrix performs the same mapping transformations on the shape as the original matrix, except that the new matrix also moves the shape horizontally by the distance specified in the deltaX parameter and vertically by the distance specified in the deltaY parameter.

The distances are specified in geometry space.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
transform_is_nil
Warnings
move_transform_out_of_range
Notices (debugging version)
mapping_unaffected

SEE ALSO

For information about mapping matrices in general, see the mathematics chapter of Inside Macintosh: QuickDraw GX Environment and Utilities.

To move a shape by altering its geometry, use the GXMoveShape function, described on page 6-66.